home *** CD-ROM | disk | FTP | other *** search
/ CD ROM Paradise Collection 4 / CD ROM Paradise Collection 4 1995 Nov.iso / filutil / yarn_077.zip / YARN.DOC < prev    next >
Text File  |  1995-01-07  |  34KB  |  976 lines

  1.  
  2.  
  3. PC Yarn User Manual - version 0.77                                             
  4.  
  5.  
  6.                PC Yarn - offline news storage and reading system
  7.  
  8.      Copyright (c) 1995 Chin Huang
  9.  
  10.      Permission to copy and distribute this material for any purpose and
  11.      without fee is hereby granted, provided that the above copyright notice
  12.      and this permission notice appear in all copies.  The author makes no
  13.      representations about the accuracy or suitability of this material for any
  14.      purpose.  It is provided "as is", without any express or implied
  15.      warranties.  The author will assume no liability for damages either from
  16.      the direct use of this product or as a consequence of the use of this
  17.      product.
  18.  
  19.  
  20.                                  INTRODUCTION
  21.  
  22.      PC Yarn is a suite of programs for your personal computer, used to store
  23.      and read USENET news and mail downloaded from a USENET host.
  24.  
  25. FEATURES
  26.  
  27.      -  An import program inserts USENET articles into a "news base" from
  28.         Simple Offline USENET Packet (SOUP) format.  For each newsgroup, you
  29.         specify the number of days to keep articles, after which, an expire
  30.         program deletes them.  However, articles containing an Expires: header
  31.         are deleted on the date specified in the header.
  32.  
  33.      -  The news base stores only one copy of a cross-posted article.  The news
  34.         base implementation stores multiple articles per file.
  35.  
  36.      -  A mail filter moves incoming mail to specific folders or deletes
  37.         incoming mail based on user defined rules.
  38.  
  39.      -  The Yarn news reader presents articles in threads arranged by
  40.         Message-ID and References headers.  The reader program generates SOUP
  41.         reply packets.
  42.  
  43.      -  Multiple users are supported by storing separate configuration files
  44.         for each user.
  45.  
  46. SYSTEM REQUIREMENTS
  47.  
  48.      -  MS-DOS 3.0 or higher
  49.  
  50.      -  compression software such as PKZIP and PKUNZIP
  51.  
  52.      -  80386 compatible CPU or better to run the 32-bit DOS extender version
  53.         of the reader program.  A real mode version of the reader is also
  54.         included for non-386 systems.
  55.  
  56.      -  a lot of hard disk storage, depending on how much news you want to
  57.         keep.  For example, the author subscribes to 120 newsgroups including
  58.         some binaries and sources groups, keeping most articles for 7 days.
  59.         The amount of disk space used is 40 megabytes.
  60.  
  61.  
  62.  
  63.  
  64.                                                                               1
  65.  
  66.  
  67.  
  68. PC Yarn User Manual - version 0.77                                             
  69.  
  70.  
  71.                                  INSTALLATION
  72.  
  73. INSTALL YARN DIRECTORY
  74.  
  75.      Unpack the files from the Yarn distribution into a directory.  Run the
  76.      command
  77.  
  78.           install [drive:]directory
  79.  
  80.      where [drive:]directory specifies where to install the Yarn data
  81.      directory.  This directory is created if it doesn't already exist.  Choose
  82.      a disk drive with a lot of free space because the news base will be stored
  83.      here.  In this document, this directory will be called the $YARN
  84.      directory.
  85.  
  86. SET UP USER DIRECTORY
  87.  
  88.      To set up a user directory where Yarn will store your user information,
  89.      run the command
  90.  
  91.           adduser
  92.  
  93.      A form appears in which you fill in the required user information.
  94.  
  95.      + Add User ------------------------------------------------------------+
  96.      |                                                                      |
  97.      |    Home directory: C:\JIM                                            |
  98.      |                                                                      |
  99.      |           User ID: jsmith                                            |
  100.      |                                                                      |
  101.      |       Host system: netcom.com                                        |
  102.      |                                                                      |
  103.      |  User's full name: Jim Smith                                         |
  104.      |                                                                      |
  105.      |    Editor program: edit                                              |
  106.      |                                                                      |
  107.      | Reply packet file: C:\UPLOAD\IOXR.ZIP                                |
  108.      |                                                                      |
  109.      +----------------------------------------------------------------------+
  110.  
  111.      Home directory
  112.           Specify the directory where Yarn will store your user information.
  113.           This directory is created if it doesn't already exist.  In this
  114.           document, this directory will be called the $HOME directory.
  115.  
  116.      User ID
  117.           Set this to your login name on the host from which you download and
  118.           upload USENET news.
  119.  
  120.      Host system
  121.           Set this to the full domain name of your host.
  122.  
  123.      User's full name
  124.           Set this to your full name.  This is the name that appears in
  125.           parentheses on the From: header in messages you send.
  126.  
  127.  
  128.  
  129.                                                                               2
  130.  
  131.  
  132.  
  133. PC Yarn User Manual - version 0.77                                             
  134.  
  135.  
  136.      Editor program
  137.           Set the name of the editor program to run when you send messages.
  138.  
  139.      Reply packet file
  140.           Specify the full path of the SOUP reply packet file where your
  141.           outgoing messages are stored.  If the reply packet file does not
  142.           exist, it is created when you post an article or send a mail message
  143.           from the reader program.  When you exit the reader program, the reply
  144.           packet is ready to upload to your host.
  145.  
  146.      The program writes the user information to a configuration file named
  147.      $HOME\yarn\config.  This document refers to other configuration settings
  148.      also stored in this file.  If you want to change those settings, you have
  149.      to edit the configuration file with a text editor.
  150.  
  151. SET TIME ZONE
  152.  
  153.      Set the environment variable TZ to your time zone.  The format of the TZ
  154.      string is
  155.  
  156.           zzz[+/-]h[h][ddd]
  157.  
  158.      zzz is a three character field representing the name of the time zone.
  159.  
  160.      [+/-]h[h] is an optionally signed number representing the local time
  161.      zone's difference from Greenwich Mean Time (GMT) in hours.  Positive
  162.      numbers adjust westward from GMT.  Negative numbers adjust eastward from
  163.      GMT.
  164.  
  165.      ddd is an optional three character field that represents the name of the
  166.      local time zone's daylight saving time.
  167.  
  168.      If no TZ environment variable is set, a default TZ=EST5EDT is assumed.
  169.  
  170. UPDATE SYSTEM FILES
  171.  
  172.      Ensure the FILES setting in the CONFIG.SYS file is set to
  173.  
  174.           FILES=20
  175.  
  176.      or higher.  If there is no FILES setting, then add it.
  177.  
  178.      Put these SET commands in the AUTOEXEC.BAT file to ensure the environment
  179.      settings persist after the next time you reboot your system.  (If you are
  180.      installing Yarn for OS/2, put the SET commands in the CONFIG.SYS file
  181.      instead.)  Use the settings determined above for the values appearing to
  182.      the right of the equal signs.
  183.  
  184.           SET YARN=$YARN
  185.           SET HOME=$HOME
  186.           SET TZ=EST5EDT
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.                                                                               3
  195.  
  196.  
  197.  
  198. PC Yarn User Manual - version 0.77                                             
  199.  
  200.  
  201. SET UP OTHER USERS
  202.  
  203.      To set up another user, run the adduser command, and specify a different
  204.      home directory.  To run Yarn as that user, set the HOME environment
  205.      variable to the user's home directory.
  206.  
  207. ENVIRONMENT
  208.  
  209.      These enviroment variables modify the behaviour of Yarn if they are set.
  210.  
  211.      EDITOR    Specifies the external editor program, overriding the editor
  212.                specified in the configuration file.
  213.  
  214.      LOGDIR    Sets the user's home directory.  If LOGDIR is not set, the home
  215.                directory is set from the HOME environment variable.
  216.  
  217.      TMP       Specifies a directory where temporary working files are stored.
  218.                The default is $YARN\temp.
  219.  
  220.      YARNRC    Specifies an alternate configuration file to read instead of the
  221.                default $HOME\yarn\config.
  222.  
  223. HOW TO ADD PGP SUPPORT
  224.  
  225.      Yarn contains hooks to external cryptographic programs.  The standard Yarn
  226.      distribution is set up to run Pretty Good Privacy (PGP).  Ensure that the
  227.      PGP executable is in the execution PATH.  Uncomment the "secret-sign",
  228.      "encrypt", "decrypt" and "decrypt-view" lines in the Yarn configuration
  229.      file.  Yarn is now configured to use the PGP privacy and authentication
  230.      functions.
  231.  
  232.  
  233.                                    OPERATION
  234.  
  235. IMPORT NEWS AND MAIL
  236.  
  237.      To import messages from SOUP format, run
  238.  
  239.           import <file>
  240.  
  241.      where <file> is the path of the SOUP file.  The import program takes these
  242.      options.
  243.  
  244.      -n        Do not delete the packet file.
  245.  
  246.      -q        Operate in quiet mode.  Do not list imported article numbers.
  247.  
  248.      -r        Import rnews batches instead of SOUP files.
  249.  
  250. SET EXPIRY OF NEWSGROUPS
  251.  
  252.      Two settings are associated with each newsgroup.  One is the number of
  253.      days that articles in the newsgroup will be kept before the expire program
  254.      deletes them.  The other is the absolute maximum number of days that
  255.      articles with an Expires: header will be kept.  The Expires: header may
  256.      contain a date far in the future, but the article will be kept only for
  257.  
  258.  
  259.                                                                               4
  260.  
  261.  
  262.  
  263. PC Yarn User Manual - version 0.77                                             
  264.  
  265.  
  266.      the specified number of days.
  267.  
  268.      When the import program finds a newsgroup in the packet that is not
  269.      already in the news base, it adds the newsgroup with keep days and maximum
  270.      keep days settings specified from the configuration file.  The "keep" and
  271.      "max-keep" settings specify the keep days and maximum keep days
  272.      respectively.  For example, if the configuration file contains the
  273.      settings
  274.  
  275.           keep=7
  276.           max-keep=30
  277.  
  278.      then articles are normally kept in the newsgroup for 7 days and absolutely
  279.      not more than 30 days.
  280.  
  281.      You can set the keep days of individual newsgroups.  Run the command
  282.  
  283.           newgroup <name> <keepDays> [<maxDays>]
  284.  
  285.      where <name> is the newsgroup name and <keepDays> is the number of days
  286.      that articles in the newsgroup will be kept before the expire program
  287.      deletes them.  The optional parameter <maxDays> is the absolute maximum
  288.      number of days that articles containing an Expires: header will be kept.
  289.  
  290.      Instead of naming a newsgroup on the command line, you can specify a text
  291.      file containing a list of newsgroup names.  Every newsgroup listed in the
  292.      file is assigned the keep days value.
  293.  
  294.           newgroup @<file> <keepDays> [<maxDays>]
  295.  
  296.  
  297. EXPIRE NEWS
  298.  
  299.      Periodically run the expire program to delete old articles from the news
  300.      base.  To expire old articles from all newsgroups, run the command
  301.  
  302.           expire -o
  303.  
  304.      To expire old articles from specific newsgroups, list the newsgroups on
  305.      the command line.  For example:
  306.  
  307.           expire -o comp.answers news.answers
  308.  
  309.      To delete all read articles in all newsgroups, run
  310.  
  311.           expire -r
  312.  
  313.      To delete read articles from specific newsgroups, run expire with the -r
  314.      option and list the newsgroups on the command line.  For example:
  315.  
  316.           expire -r comp.answers news.answers
  317.  
  318.      The program may expire newsgroups in addition to the newsgroups you
  319.      specified if an expired article was crossposted to multiple newsgroups.
  320.  
  321.  
  322.  
  323.  
  324.                                                                               5
  325.  
  326.  
  327.  
  328. PC Yarn User Manual - version 0.77                                             
  329.  
  330.  
  331.      You can specify a text file containing a list of newsgroups to expire.
  332.      Run expire with the argument
  333.  
  334.           @<file>
  335.  
  336.      on the command line, where <file> is the file path.
  337.  
  338.      The expire program accepts these options:
  339.  
  340.      -d<n>     Assume it is <n> days in the future.  Use this option to expire
  341.                articles before they normally would have been expired.
  342.  
  343.      -n        Do not actually delete any articles.  Used for testing.
  344.  
  345.      -o        Delete old articles.
  346.  
  347.      -q        Operate in quiet mode.  Display fewer messages than usual.
  348.  
  349.      -r        Delete read articles.
  350.  
  351. REMOVE NEWSGROUP
  352.  
  353.      To remove a newsgroup from the news base, run the command
  354.  
  355.           rmgroup <name>
  356.  
  357.      where <name> is the newsgroup name.
  358.  
  359. USING THE MAIL FILTER
  360.  
  361.      The mail filter looks at incoming mail messages and processes the messages
  362.      based on a set of rules you define.  You can set up a rule that
  363.      automatically moves messages you receive from a mailing list to a specific
  364.      folder.  Or, you can automatically delete messages from a specific user so
  365.      that you don't even see messages from that user.
  366.  
  367.      Run the filter program to set up the filter rules.  A list of filter rules
  368.      appears.  To add a filter rule, press the [Ins] key.  The mail rule form
  369.      appears.
  370.  
  371.      + Mail Rule ----------------------------------------------------------+
  372.      |                                                                     |
  373.      | Rule name: Yarn Mailing List                                        |
  374.      |                                                                     |
  375.      | Search in: ( ) From          Search for: yarn-list                  |
  376.      |            (*) To            Match case: No                         |
  377.      |            ( ) Subject                                              |
  378.      |            ( ) Headers                                              |
  379.      |            ( ) Body                                                 |
  380.      |            ( ) Headers and body                                     |
  381.      |                                                                     |
  382.      |    Action: (*) Move to folder/newsgroup: list.yarn                  |
  383.      |            ( ) Delete                                               |
  384.      |                                                                     |
  385.      +---------------------------------------------------------------------+
  386.  
  387.  
  388.  
  389.                                                                               6
  390.  
  391.  
  392.  
  393. PC Yarn User Manual - version 0.77                                             
  394.  
  395.  
  396.      Rule name
  397.           Enter a name for the rule.  Filter rules are processed in sorted
  398.           order by rule name.  Each rule is checked in turn until a match is
  399.           found.  If no rules match, the message is moved to the INBOX folder.
  400.  
  401.      Search in
  402.           Select where to search.  If you select "To", then the To: and Cc:
  403.           headers are searched.
  404.  
  405.      Search for
  406.           Enter the string to search for in the selected header.
  407.  
  408.      Match case
  409.           Set the field to Yes if you want the search to be case sensitive.
  410.  
  411.      Action
  412.           Select "Move to folder/newsgroup" if you want to move the message to
  413.           a specific folder or newsgroup.  If the specified name is a newsgroup
  414.           in the news base, the message is moved to the newsgroup, otherwise
  415.           the message is moved to the named folder.  Select "Delete" if you
  416.           want to automatically delete the message.
  417.  
  418.      The mail filter allows you to automatically transfer messages from a
  419.      mailing list into a newsgroup.  You can also set up Yarn to send any posts
  420.      you make to that newsgroup back to the mailing list.  For example, suppose
  421.      you want to filter messages from the Yarn mailing list into a newsgroup.
  422.      Run the command
  423.  
  424.           newgroup list.yarn 7 30 yarn-list@lists.colorado.edu
  425.  
  426.      to create a newsgroup named list.yarn.  Set up a mail filter rule to move
  427.      messages from the mailing list into the newsgroup.  Now when you post a
  428.      message to the list.yarn newsgroup, it is mailed to the list address
  429.      yarn-list@lists.colorado.edu.
  430.  
  431. READ NEWS
  432.  
  433.      Run the yarn program to read news and mail.  The yarnx program uses a DOS
  434.      extender, which uses the CPU's memory management functions to give the
  435.      program access to much more memory than conventional DOS programs.  It
  436.      requires an 80386 compatible CPU or better.  The file DOS4GW.EXE also must
  437.      be in a directory in the PATH.  With more available memory, the program
  438.      can list much more articles in a newsgroup.
  439.  
  440.      The reader program operates in several modes -- the newsgroup selection
  441.      level, the article selection level, and the article reading level.
  442.  
  443.      In the newsgroup selection level, yarn displays a window listing the
  444.      newsgroups you are subscribed to along with the number of unread articles
  445.      in each newsgroup.  You can subscribe, unsubscribe or rearrange the order
  446.      of newsgroups in this list.  Press the [Ins] key to subscribe to a
  447.      newsgroup.  This brings up a list of unsubscribed newsgroups.  To make a
  448.      selection, use the arrow keys to move the highlight to the newsgroup, and
  449.      then press the [Enter] key.  The selected newsgroup is inserted into the
  450.      subscribed newsgroup list.  Press the [Del] key to unsubscribe from the
  451.      highlighted newsgroup.  To move a newsgroup in the list, press the [Del]
  452.  
  453.  
  454.                                                                               7
  455.  
  456.  
  457.  
  458. PC Yarn User Manual - version 0.77                                             
  459.  
  460.  
  461.      key to remove it, position the highlight to the desired location, then
  462.      press the [Ins] key and reinsert the newsgroup.
  463.  
  464.      By selecting a newsgroup, you go to the article selection level, where
  465.      yarn presents a list of the subjects of each article.  A subject beginning
  466.      with the greater than (>) symbol indicates an article belonging to the
  467.      thread above it in the list, but the author of the article changed the
  468.      subject.  You can select an article to read from this list, taking you to
  469.      the article reading level.
  470.  
  471. NEWSGROUP SELECTION LEVEL
  472.  
  473.      These commands are available in the newsgroup selection level.
  474.  
  475.      Down Arrow, Ctrl-N
  476.           Move to the next newsgroup.
  477.  
  478.      Up Arrow, Ctrl-P
  479.           Move to the previous newsgroup.
  480.  
  481.      Tab, N
  482.           Move to the next newsgroup that contains unread articles.
  483.  
  484.      Shift-Tab, P
  485.           Move to the previous newsgroup that contains unread articles.
  486.  
  487.      Home Move to first newsgroup.
  488.  
  489.      End  Move to last newsgroup.
  490.  
  491.      /    Search forward for newsgroup name containing matching text.
  492.  
  493.      ?    Search backward for newsgroup name containing matching text.
  494.  
  495.      ;    Continue forward search.
  496.  
  497.      :    Continue backward search.
  498.  
  499.      Space, Right Arrow
  500.           Go to the article selection level, listing only unread articles.
  501.  
  502.      Enter
  503.           Go to the article selection level, listing all articles.
  504.  
  505.      Ins, +
  506.           Subscribe to a newsgroup and insert the newsgroup at the current
  507.           position.
  508.  
  509.      Del, -
  510.           Unsubscribe from the highlighted newsgroup.
  511.  
  512.      A    Post an article to the highlighted newsgroup.
  513.  
  514.      C    Mark all articles in the highlighted newsgroup as read.
  515.  
  516.  
  517.  
  518.  
  519.                                                                               8
  520.  
  521.  
  522.  
  523. PC Yarn User Manual - version 0.77                                             
  524.  
  525.  
  526.      O    Save unread articles in the highlighted newsgroup to a folder.
  527.  
  528.      S    Save unread articles in the highlighted newsgroup to a file.  The
  529.           program prompts for a file name.  If you don't give a full path name,
  530.           the file is stored in the directory $HOME\news.
  531.  
  532.      W    Same as 'S' command, except omit the article headers.
  533.  
  534.      !    Run command shell.  Type "exit" to return to Yarn.
  535.  
  536.      F2, Ctrl-L
  537.           List address book.
  538.  
  539.      Esc  Exit program
  540.  
  541. ARTICLE SELECTION LEVEL
  542.  
  543.      These commands are available in the article selection level.
  544.  
  545.      Down Arrow, Ctrl-N
  546.           Move to the next article.
  547.  
  548.      Up Arrow, Ctrl-P
  549.           Move to the previous article.
  550.  
  551.      Tab, N
  552.           Move to the first article of the next thread.
  553.  
  554.      Shift-Tab, P
  555.           Move backwards to the previous article beginning a thread.
  556.  
  557.      Home Move to first article.
  558.  
  559.      End  Move to last article.
  560.  
  561.      /    Search forward for article containing matching text.
  562.  
  563.      ?    Search backward for article containing matching text.
  564.  
  565.      ;    Continue forward search.
  566.  
  567.      :    Continue backward search.
  568.  
  569.      Space, Right Arrow
  570.           Read the article.
  571.  
  572.      Del, -
  573.           Mark the article as read and go to the next unread article.
  574.  
  575.      Ins, +
  576.           Mark the article as unread.
  577.  
  578.      O    Save the current article through to the last article in the thread to
  579.           a folder.
  580.  
  581.  
  582.  
  583.  
  584.                                                                               9
  585.  
  586.  
  587.  
  588. PC Yarn User Manual - version 0.77                                             
  589.  
  590.  
  591.      S    Save the current article through to the last article in the thread to
  592.           a file.  The program prompts for a file name.  If you don't give a
  593.           full path name, the file is stored in the directory $HOME\news.
  594.  
  595.      W    Same as 'S' command, except omit the article headers.
  596.  
  597.      K    Mark the current article through to the last article in the thread as
  598.           read.
  599.  
  600.      U    Mark the current article through to the last article in the thread as
  601.           unread.
  602.  
  603.      C    Mark all articles in the newsgroup as read.
  604.  
  605.      A    Post an article to the newsgroup.
  606.  
  607.      !    Run command shell.  Type "exit" to return to Yarn.
  608.  
  609.      F2, Ctrl-L
  610.           List address book.
  611.  
  612.      F3, Ctrl-A
  613.           Add the author of the current message to the address book.
  614.  
  615.      Esc, Left Arrow
  616.           Return to the newsgroup selection level.
  617.  
  618. ARTICLE READING LEVEL
  619.  
  620.      These commands are available in the article reading level.
  621.  
  622.      Down Arrow, Enter
  623.           Scroll one line down.
  624.  
  625.      Up Arrow
  626.           Scroll one line up.
  627.  
  628.      PgDn Show next page.
  629.  
  630.      Space
  631.           Show next page.  If at the end of an article, go to the next unread
  632.           article.
  633.  
  634.      PgUp, b
  635.           Show previous page.
  636.  
  637.      Home Go to top of article.
  638.  
  639.      g    Search article for matching text.
  640.  
  641.      G    Continue search in article.
  642.  
  643.      /    Search forward for article containing matching text.
  644.  
  645.  
  646.  
  647.  
  648.  
  649.                                                                              10
  650.  
  651.  
  652.  
  653. PC Yarn User Manual - version 0.77                                             
  654.  
  655.  
  656.      ?    Search backward for article containing matching text.
  657.  
  658.      ;    Continue forward search.
  659.  
  660.      :    Continue backward search.
  661.  
  662.      n, Right Arrow
  663.           Mark the article as read and show the next unread article.
  664.  
  665.      N    Show next article.
  666.  
  667.      p    Show previous unread article.
  668.  
  669.      P    Show previous article.
  670.  
  671.      a, A Post an article to the newsgroup.
  672.  
  673.      f    Post a followup article.
  674.  
  675.      F    Post a followup article, quoting the original article.
  676.  
  677.      r    Mail a reply to the author of the article.
  678.  
  679.      R    Mail a reply, quoting the original article.
  680.  
  681.      m    Mail the article to someone.
  682.  
  683.      o    Save the article to a folder.
  684.  
  685.      s    Save the article to a file.  The program prompts for a file name.  If
  686.           you don't give a full path name, the file is stored in the directory
  687.           $HOME\news.
  688.  
  689.      w    Same as 's' command, except omit article headers.
  690.  
  691.      x    ROT13 decrypt the article.
  692.  
  693.      X    Decrypt the article by running the external cryptography program
  694.           specified in the Yarn configuration.
  695.  
  696.      k, Del
  697.           Mark the article as read.
  698.  
  699.      K    Mark this article and the rest of the articles in the thread as read.
  700.  
  701.      u, Ins
  702.           Mark the article as unread.
  703.  
  704.      U    Mark this article and the rest of the articles in the thread as
  705.           unread.
  706.  
  707.      C    Mark all the articles in the newsgroup as read.
  708.  
  709.      v    Toggle verbose headers.
  710.  
  711.  
  712.  
  713.  
  714.                                                                              11
  715.  
  716.  
  717.  
  718. PC Yarn User Manual - version 0.77                                             
  719.  
  720.  
  721.      c    Cancel the article.  You must be the author to be able to cancel the
  722.           article.
  723.  
  724.      z    Supersede the article.  You must be the author to be able to
  725.           supersede the article.
  726.  
  727.      !    Run command shell.  Type "exit" to return to Yarn.
  728.  
  729.      F2, Ctrl-L
  730.           List address book.
  731.  
  732.      F3, Ctrl-A
  733.           Add the author of the current message to the address book.
  734.  
  735.      Esc, Left Arrow
  736.           Return to the article selection level.
  737.  
  738.      q    Return to the newsgroup selection level.
  739.  
  740. READ MAIL
  741.  
  742.      To read mail, press [Shift-M] at the newsgroup selection level.  This
  743.      brings up a list of mail messages you received.
  744.  
  745.      If you have no mail, you are given the opportunity to send mail.  A form
  746.      pops up, asking you to enter the destination mail address and subject for
  747.      the message you want to send.  If you press the [F2] key while the cursor
  748.      is in the mail address field, the address book pops up.  You can select an
  749.      entry from the address book by moving the highlight with the arrow keys
  750.      and pressing the [Enter] key.
  751.  
  752.      Press [Shift-F] at the newsgroup selection level to bring up a list of
  753.      folders.  You can select a folder to read from this list.
  754.  
  755.      If you start yarn with the -m option, you go directly to reading your
  756.      received mail and skip reading news.  If you start yarn with the -f
  757.      option, you go directly to the folder list and skip reading news.
  758.  
  759. EDIT REPLIES
  760.  
  761.      The Yarn reader allows you to edit the messages in the reply packet.  At
  762.      the newsgroup selection level, press [Shift-R] to display a list of
  763.      folders in the reply packet.  The reply packet may contain up to two
  764.      folders, ``mail'' which holds outgoing mail messages, and ``news'' which
  765.      holds outgoing USENET articles.
  766.  
  767.      By selecting a folder, you go to the message selection level, where the
  768.      program lists the messages in the folder.  Press the [Del] key to delete
  769.      the currently highlighted message.  Press [Shift-E] to edit the message.
  770.  
  771.      To view a message, select it from the message selection level.  While a
  772.      message is displayed, pressing the 'd' key deletes the message.  Press the
  773.      'e' key to edit the message.
  774.  
  775.  
  776.  
  777.  
  778.  
  779.                                                                              12
  780.  
  781.  
  782.  
  783. PC Yarn User Manual - version 0.77                                             
  784.  
  785.  
  786.      If you start yarn with the -r option, you go directly to the replies list
  787.      and skip reading news.
  788.  
  789. USING THE ADDRESS BOOK
  790.  
  791.      The address book is used to conveniently retrieve mail addresses.  An
  792.      address book entry consists of an alias and an address.  An alias is a
  793.      word representing a address or a list of addresses.  If an alias appears
  794.      in a To:, Cc:, or Bcc: header, it is replaced with the corresponding
  795.      address(es) when the message is sent.
  796.  
  797.      To list the address book, press [F2] at the newsgroup selection level.  To
  798.      add an address book entry, press the [Ins] key.  A form appears in which
  799.      you enter the alias and address.  To specify a list of addresses, enter
  800.      the addresses in the Address: field, separating them with a comma.
  801.  
  802.      While you are reading a message, you can capture the mail address of the
  803.      message author and add it to the address book by pressing the [F3] key.
  804.  
  805. YARN OPTION SUMMARY
  806.  
  807.      The yarn program accepts these options:
  808.  
  809.      -b   Output to the display using BIOS calls instead of direct screen
  810.           writes.
  811.  
  812.      -f   List folders.  Do not read news.
  813.  
  814.      -m   List mail.  Do not read news.
  815.  
  816.      -r   List replies.  Do not read news.
  817.  
  818.      -s   Disable the '!' run shell command.
  819.  
  820. QUESTIONS AND ANSWERS
  821.  
  822.      ``How do I create SOUP files on my UNIX host?''
  823.  
  824.           The uqwk program creates and processes SOUP files on your UNIX host.
  825.           It is available by anonymous FTP from ftp.gte.com in the /pub/uqwk
  826.           directory.
  827.  
  828.           To create a SOUP download packet, named "down.zip" in this example,
  829.           run these commands on your UNIX host:
  830.  
  831.                uqwk +n +x +L
  832.                zip -m down.zip AREAS *.MSG
  833.  
  834.           Download the down.zip file to your PC.  Run this command on your PC
  835.           to insert the messages into the Yarn news base:
  836.  
  837.                import down.zip
  838.  
  839.           When you send mail or post articles, the Yarn reader creates a SOUP
  840.           reply packet, named "up.zip" in this example.  Upload the up.zip file
  841.           to your UNIX host.  Run these commands on your UNIX host to send the
  842.  
  843.  
  844.                                                                              13
  845.  
  846.  
  847.  
  848. PC Yarn User Manual - version 0.77                                             
  849.  
  850.  
  851.           messages in the reply packet:
  852.  
  853.                unzip -U up.zip
  854.                uqwk -m -n +L -RREPLIES
  855.  
  856.  
  857.      ``Sometimes when I select a newsgroup by pressing the space bar from the
  858.      newsgroup selection level, yarn lists less articles than the number of
  859.      unread articles shown.''
  860.  
  861.           This occurs if the newsgroup you selected contains cross-posted
  862.           articles that you already read in another newsgroup.  The program
  863.           marks these articles as read and updates the count of unread articles
  864.           when you select the newsgroup.
  865.  
  866.      ``After running expire, I reduced the keep days for a newsgroup and ran
  867.      expire again, but it didn't delete any more articles.''
  868.  
  869.           Each article is assigned an expiry date after which it is deleted.
  870.           The expire program deletes articles having an expiry date older than
  871.           the current date.  The article storage scheme requires that an
  872.           article's expiry date be set when the article is imported into the
  873.           news base.  Once imported, the article's expiry date cannot be
  874.           changed.  When you change the keep days for a newsgroup, you only
  875.           change how long you keep subsequently imported articles.  You don't
  876.           affect the expiry dates of articles already in the news base.
  877.  
  878.      ``What is the junk newsgroup?''
  879.  
  880.           When the import program finds an article that doesn't belong to any
  881.           of the newsgroups in the news base, it tosses the article into the
  882.           junk newsgroup.  This usually shouldn't happen with properly
  883.           configured software.
  884.  
  885.      ``How do I configure Yarn for OS/2 to run the MS-DOS version of PKZIP and
  886.      PKUNZIP?''
  887.  
  888.           Put these settings in your configuration file, adjusting the drive
  889.           and path appropriately.
  890.  
  891.                compress=c:\os2\cmd.exe /c c:\path\pkzip -m %f %d\*.*
  892.                uncompress=c:\os2\cmd.exe /c c:\path\pkunzip -o %f %d
  893.  
  894.  
  895.      ``How do I configure Yarn to use InfoZip's zip and unzip programs?''
  896.  
  897.           Put these settings in the configuration file.
  898.  
  899.                compress=zip -kjm %f %d/*
  900.                uncompress=unzip -o %f
  901.  
  902.  
  903.      ``How do I print an article from the reader program?''
  904.  
  905.  
  906.  
  907.  
  908.  
  909.                                                                              14
  910.  
  911.  
  912.  
  913. PC Yarn User Manual - version 0.77                                             
  914.  
  915.  
  916.           Use the save to file command.  When prompted for a file name, enter
  917.           the name
  918.  
  919.                prn
  920.  
  921.  
  922.      ``Is there a Yarn mailing list?''
  923.  
  924.           Yes, to subscribe to the mailing list, mail a message to
  925.           listproc@lists.colorado.edu.  The body of the message should be the
  926.           line
  927.  
  928.                subscribe yarn-list <your full name>
  929.  
  930.           where <your full name> is your full name.
  931.  
  932. FILES
  933.  
  934.      $HOME\mail             Folder directory
  935.      $HOME\news             Default save directory
  936.      $HOME\replies          Reply work directory
  937.      $HOME\yarn             User configuration directory
  938.      $HOME\yarn\addrbook    Address book file
  939.      $HOME\yarn\config      User configuration file
  940.      $HOME\yarn\filter      Mail filter configuration file
  941.      $HOME\yarn\newsrc      Newsgroup subscription file
  942.      $HOME\yarn\readart.*   Read cross-posted article lookup table
  943.  
  944.      $YARN\active           Active newsgroup file
  945.      $YARN\history.*        Article history lookup table
  946.      $YARN\supersed.*       Superseded article lookup table
  947.      $YARN\overview         Article overview directory
  948.      $YARN\news             Article spool file directory
  949.  
  950.  
  951.                                ACKNOWLEDGEMENTS
  952.  
  953.      The MS-DOS yarn.exe program uses the SPAWNO routines by Ralf Brown to
  954.      minimize memory use while shelling to DOS and running other programs.
  955.  
  956.  
  957.  
  958.  
  959.  
  960.  
  961.  
  962.  
  963.  
  964.  
  965.  
  966.  
  967.  
  968.  
  969.  
  970.  
  971.  
  972.  
  973.  
  974.                                                                              15
  975.  
  976.